home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
United Public Domain Gold 2
/
United Public Domain Gold 2.iso
/
utilities
/
pu178.dms
/
pu178.adf
/
DOCUMENTATION
/
OTHERS
/
Selector.doc
< prev
next >
Wrap
Text File
|
1994-11-01
|
6KB
|
151 lines
Program Selector V3.0 (March 1991)
===================================
This program is freeware, this means that you can copy it freely as long
as you don't ask any more money for it than a nominal fee for copying. If
you want to distribute this program you should keep this document with it.
This program cannot be used for commercial purposes without written
permission from the author.
If you have suggestions or remarks about this program, or if you find
any bugs, please let me know.
Program Selector was written to help the user assemble programs on a
boot disk and start them in a userfriendly way. It can execute any program
that can be started from the CLI.
USAGE:
Program Selector must be started from CLI:
"1> Selector [-h] [<filename>]"
-h : When this option is used the two columns will be filled evenly.
filename : This is the optional filename of the script, if you don't
specify a name 's:Selector.programs' will be read.
FILE LIST :
Program Selector will read a script and scan it in the following manner:
line| description | example |
----+------------------------------------+-----------------------------------+
1 | Title | Utilities |
2 | text for 1st gadget (max 37 char) | MicroEmacs 1.3 |
3 | command sequence (max 128 char) | *:c/emacs |
4 | text for 2nd gadget | AmigaDOS Ed |
5 | 2nd command sequence | *:c/ed |
. | ... | ... |
The command sequence consists of any number of commands seperated by ';'.
The following characters all have a special meaning, use them as the first
character of a command:
'*' : Put a '*' in front of the MAIN program if you want to multitask.
If you don't want to be able to multitask a program don't put a
'*' in front of the main program. (see RUN mode)
'#' : When there is a '#' in front of a program it will allways be
launched, even in EXEC or RUN mode (see later). (Useful for
programs who need as much memory as possible or don't return to
the CLI.)
'!' : The prompt command. The string following the '!' is no command but
a prompt. A string gadget will appear and prompt you for the
arguments to be passed to the next command. (The '!' must be the
command directly in front of the command you want the parameters to
be passed to.
'<' : Read new file list. The selector will read the file directly
following the '<' and will use this to display a new file list.
(Useful to implement some sort of sub-menus.)
'@' : If you want to use a subtitle enter a '@' instead of the command
sequence, the text will appear as a subtitle and can't be
selected.
NOTE : - Include the path to avoid problems, e.g. 'sys:Program' instead of
'Program'. Be careful when you use spaces !
Example script:
UTILITIES
This program is the editor
!Edit what file ? ;*c:MicroEMACS
This is a subtitle
@
This program doesn't work with fast memory
c:Run SYS:System/NoFastMem;*:ProgramName
GADGETS:
There are 22 gadgets for the file text in NTSC and 32 in PAL,
so you can start 22 programs if you've got a NTSC Amiga and 32 with a PAL
Amiga (minus the number of subtitles).
At the top right are two invisible depth-gadgets so you can depth arrange
the Selector-window.
The top left contains the RUN-EXEC-LAUNCH gadget. This gadget indicates
whether the programs will be EXECuted (the Selector will disappear and return
after the program has finished), RUN (the program will multitask and you
can keep on using the Selector) or LAUNCHed (the Selector will disappear and
stay away, the startup-sequence will continue after the Selector command).
You can force a LAUNCH by putting a '#' in front of the main program, no
matter what mode you are in, the program will be LAUNCHed.
OTHER FUNCTIONS:
At the top right the selector will print the number of free bytes. This
number will constantly update if the selector window is active.
When you click the right mouse button the Selector window will shrink to
a small window the size of a title-bar. Click the right button again to get
the main window back.
The small window also contains a close gadget, when you press this the
execution of the startup-sequence will continue after the Selector command.
The Selector will automatically select PAL or NTSC mode.
INSTALLATION:
To install Program Selector on a boot disk, you should copy these files:
c:Selector -> YourDisk:c
Selector.doc -> YourDisk:
PPMore -> YourDisk:c
c:Run -> YourDisk:c
Then you must create in YourDisk:s the Selector.programs file. I suggest
you make the two last lines of your file :
About Program Selector
*:c/PPMore :Selector.doc
The last thing you must do is place the command 'Selector' in your
Startup-Sequence to invoke the Program Selector.
EXAMPLE:
To try Program Selector out, open a CLI, CD to the directory where the
'Selector' command and the example scripts are, and type:
"1> Selector Selector.programs"
You'll be presented with a menu from a utility disk, please note that you
won't be able to execute anything, it's only an example script. To get an
example of a prompt select 'RUN' then 'TrackDisplay'. Press the right button
followed by the close gadget to quit.
I hope you find this program useful,
Nico.
Send bug reports, suggestions, etc...
Nico François
Corbielaan 13
B-3060 Bertem
BELGIUM